Zum Hauptinhalt springen

View-Referenz

Diese Seite dokumentiert alle 24 versionslosen Views, die Insight Analytics in der Zieldatenbank anlegt, mit sämtlichen Spalten, Datentypen und Bedeutungen. Konzept, Verbindung und Beispielabfragen beschreibt die Seite Datenbank-Views; die angegebenen Datentypen gelten für das Zielsystem PostgreSQL.

Konventionen

  • Bezeichner: In PostgreSQL sind alle Tabellen-, View- und Spaltennamen in doppelten Anführungszeichen angelegt und damit case-sensitiv — in Abfragen exakt und in doppelten Anführungszeichen schreiben ("CDR_Summary", "Account_ID").
  • Konto- und Dienst-IDs: ID-Spalten tragen die Standort-Kennung der Anlage als Präfix, Format Standort-UUID_ID (Trennzeichen _). Sie sind damit auch bei mehreren angebundenen Anlagen eindeutig und dienen als Verknüpfungsschlüssel zwischen den Views. Negative ID-Werte sind Platzhalterkonten („kein Konto", „gelöschtes Konto").
  • Zeitstempel: Alle TIMESTAMP-Spalten enthalten die lokale Anlagenzeit der STARFACE ohne Zeitzonenangabe.
  • Dauerspalten: Suffixe _s, _m, _h bezeichnen dieselbe Dauer in Sekunden, Minuten bzw. Stunden (gerundete DECIMAL-Werte).
  • _i18n-Spalten: sprachabhängige Anzeigetexte in der konfigurierten Berichtssprache des Moduls (Deutsch, Englisch oder Französisch). Die Beispielwerte in dieser Referenz zeigen die deutsche Berichtssprache. Für maschinelle Auswertungen die zugehörige sprachneutrale Spalte verwenden.

Gesprächsdaten

CDR_Summary

Tabelle CDR_Summary_4. Die zentrale Auswertungsquelle: je Anruf ein aufbereiteter, klassifizierter Datensatz; bei Weiterleitungen entsteht je Weiterleitungsziel ein Datensatz. Nicht repräsentative Zwischenzeilen der Klassifizierung tragen is_garbage = true — für Auswertungen stets NOT "is_garbage" filtern.

SpalteTypBedeutung
call_idTEXTAnruf-ID aus dem STARFACE-CDR (mit Standortpräfix); verknüpft CDR_Summary mit CDR_Data
answeredBOOLEANAnruf wurde angenommen
answered_elsewhereTEXTKennzeichen aus dem STARFACE-CDR: Anruf wurde anderweitig angenommen
call_resultTEXTAnrufergebnis aus dem STARFACE-CDR; bei Weiterleitungen z. B. FORWARD_TIMEOUT, FORWARD_BUSY, FORWARD_UNCONDITIONAL, FORWARD_USER_INTERACTIVE
call_result_timeTIMESTAMPZeitpunkt des Anrufendes (Eintritt des Anrufergebnisses)
callback_numberTEXTRückrufnummer aus dem STARFACE-CDR
called_account_idTEXTKonto-ID des angerufenen Kontos — Schlüssel zu Called_Account
called_caller_idTEXTÜbermittelte Rufnummernanzeige (Caller-ID) des Angerufenen
called_nameTEXTName des Angerufenen
called_numberTEXTRufnummer des Angerufenen
caller_account_idTEXTKonto-ID des anrufenden Kontos — Schlüssel zu Caller_Account
caller_caller_idTEXTÜbermittelte Rufnummernanzeige (Caller-ID) des Anrufers
caller_nameTEXTName des Anrufers
caller_numberTEXTRufnummer des Anrufers
cdr_account_idTEXTKonto, unter dem der CDR-Datensatz geführt wird — Schlüssel zu CDR_Account; identifiziert zusammen mit call_id und incoming einen Datensatz
dialed_numberTEXTTatsächlich gewählte Rufnummer
duration_sDECIMALGesamtdauer des Anrufs in Sekunden (call_result_timestart_time)
has_faxBOOLEANFax-Kennzeichen aus dem STARFACE-CDR
has_monitorBOOLEANMonitor-Kennzeichen aus dem STARFACE-CDR
has_voicemailBOOLEANVoicemail-Kennzeichen aus dem STARFACE-CDR
incomingBOOLEANtrue = eingehender, false = ausgehender Anruf
line_nameTEXTName der verwendeten Leitung
link_timeTIMESTAMPZeitpunkt der Gesprächsannahme; bei nie verbundenen Anrufen gleich call_result_time (Gesprächsdauer 0)
ringing_timeTIMESTAMPBeginn des Klingelns; hat der Anruf nie geklingelt, gleich link_time (Klingeldauer 0)
start_timeTIMESTAMPBeginn des Anrufs
call_result_caused_byTEXTKonto-ID, die das Anrufergebnis verursacht hat — Schlüssel zu Call_Result_Account
service_idTEXTSTARFACE-Dienst des Anrufs — Schlüssel zu Service_for_CDR_Summary
called_backBOOLEANRückruf-Status aus der Insight Analytics-Oberfläche; nachträgliche Änderungen werden stündlich per UPDATE übernommen
called_back_authorTEXTBenutzer, der den Rückruf-Status zuletzt gesetzt hat
called_back_modifiedTIMESTAMPZeitpunkt der letzten Änderung des Rückruf-Status
commentTEXTKommentar zum Anruf aus der Insight Analytics-Oberfläche; nachträgliche Änderungen werden stündlich per UPDATE übernommen
comment_authorTEXTBenutzer, der den Kommentar zuletzt geändert hat
comment_modifiedTIMESTAMPZeitpunkt der letzten Kommentaränderung
answered_i18nTEXTAnzeigetext zu answered — „Angenommen" / „Nicht Angenommen"
has_fax_i18nTEXTAnzeigetext zu has_fax — „Mit Fax" / „Ohne Fax"
has_monitor_i18nTEXTAnzeigetext zu has_monitor — „Mit Monitor" / „Ohne Monitor"
has_voicemail_i18nTEXTAnzeigetext zu has_voicemail — „Mit Voicemail" / „Ohne Voicemail"
incoming_i18nTEXTAnzeigetext zu incoming — „Eingehend" / „Ausgehend"
start_time_minuteTIMESTAMPstart_time, auf die Minute gerundet (Datumshierarchie für Berichte)
start_time_hourTIMESTAMPstart_time, auf die Stunde gerundet
start_time_dayTIMESTAMPstart_time, auf den Tag gerundet
start_time_monthTIMESTAMPstart_time, auf den Monat gerundet
start_time_yearTIMESTAMPstart_time, auf das Jahr gerundet
start_time_bin_30mTEXTWochentag und 30-Minuten-Raster des Anrufbeginns, Format MON_08:30-08:59
start_time_bin_30m_i18nTEXTSprachabhängige Variante, z. B. „Montag 08:30-08:59"
duration_mDECIMALGesamtdauer in Minuten
duration_hDECIMALGesamtdauer in Stunden
talk_duration_sDECIMALGesprächsdauer in Sekunden (call_result_timelink_time)
talk_duration_mDECIMALGesprächsdauer in Minuten
talk_duration_hDECIMALGesprächsdauer in Stunden
ringing_duration_sDECIMALKlingeldauer in Sekunden (link_timeringing_time)
ringing_duration_mDECIMALKlingeldauer in Minuten
ringing_duration_hDECIMALKlingeldauer in Stunden
waiting_time_sDECIMALWartezeit bis zur Annahme in Sekunden (link_timestart_time)
waiting_time_mDECIMALWartezeit in Minuten
waiting_time_hDECIMALWartezeit in Stunden
announcement_duration_sDECIMALDauer zwischen Anrufbeginn und Klingelbeginn in Sekunden (ringing_timestart_time), z. B. Ansagen oder Warteschleife
announcement_duration_mDECIMALAnsagedauer in Minuten
announcement_duration_hDECIMALAnsagedauer in Stunden
other_participant_numberTEXTRufnummer der Gegenstelle — bei eingehenden Anrufen der Anrufer, bei ausgehenden der Angerufene
other_participant_nameTEXTName der Gegenstelle
other_participant_calleridTEXTRufnummernanzeige (Caller-ID) der Gegenstelle
other_participant_name_numberTEXTKombination „Name Nummer" der Gegenstelle — für Suche und Filter
call_origin_typeTEXTUrsprung des Anrufs: Internal oder External
call_origin_type_i18nTEXTAnzeigetext dazu — „Intern" / „Extern"
caller_name_numberTEXTKombination „Name Nummer" des Anrufers
callee_name_numberTEXTKombination „Name Nummer" des Angerufenen
is_garbageBOOLEANtrue = technischer Hilfsdatensatz der Klassifizierung (z. B. Mehrfacheinträge eines Gruppenanrufs); in Auswertungen ausfiltern
is_group_callBOOLEANAnruf wurde als Gruppenanruf klassifiziert
is_iqueue_callBOOLEANAnruf wurde als iQueue-Anruf (Warteschlange) klassifiziert
is_user_callBOOLEANAnruf wurde als Benutzeranruf klassifiziert
user_call_account_idTEXTBei Benutzeranrufen die Konto-ID des Benutzers — Schlüssel zu User_Call_Account
group_call_account_idTEXTBei Gruppen-/iQueue-Anrufen die Konto-ID der Gruppe bzw. Warteschlange — Schlüssel zu Group_Call_Account
pbx_location_nameTEXTName des Anlagen-Standorts
starface_versionTEXTSTARFACE-Version zum Zeitpunkt des Anrufs

CDR_Data

Tabelle CDR_Data_4. Rohdaten aus dem STARFACE-CDR: je Anrufschritt ein Datensatz (ein Anruf besteht aus einem oder mehreren Schritten, etwa bei Umleitungen oder Gruppenverteilung). Verknüpfung mit CDR_Summary über call_id.

SpalteTypBedeutung
call_idTEXTAnruf-ID (mit Standortpräfix) — verknüpft alle Schritte eines Anrufs und die zugehörige CDR_Summary-Zeile
call_step_idTEXTID des einzelnen Anrufschritts innerhalb des Anrufs; -1, wenn nicht gesetzt
call_leg_uuidTEXTUUID des Call-Legs aus dem STARFACE-CDR
cdr_account_idTEXTKonto, unter dem der Schritt geführt wird — Schlüssel zu CDR_Account_CDR_Data
caller_account_idTEXTKonto-ID des Anrufers — Schlüssel zu Caller_Account_CDR_Data
caller_caller_idTEXTRufnummernanzeige (Caller-ID) des Anrufers
called_account_idTEXTKonto-ID des Angerufenen — Schlüssel zu Called_Account_CDR_Data
called_caller_idTEXTRufnummernanzeige (Caller-ID) des Angerufenen
service_idTEXTSTARFACE-Dienst des Schritts — Schlüssel zu Service_for_CDR_Data
start_timeTIMESTAMPBeginn des Anrufschritts
ringing_timeTIMESTAMPKlingelbeginn des Schritts; ohne Klingeln gleich link_time
link_timeTIMESTAMPAnnahmezeitpunkt des Schritts; ohne Verbindung gleich call_result_time
call_resultTEXTErgebnis des Schritts aus dem STARFACE-CDR (z. B. Weiterleitungstypen FORWARD_…)
call_result_timeTIMESTAMPEndzeitpunkt des Schritts
call_result_caused_byTEXTKonto-ID, die das Ergebnis verursacht hat — Schlüssel zu Call_Result_Account_CDR_Data
line_idTEXTID der verwendeten Leitung
line_nameTEXTName der verwendeten Leitung
callback_numberTEXTRückrufnummer aus dem STARFACE-CDR
answered_elsewhereTEXTKennzeichen „anderweitig angenommen" als Text (true/false)
incomingTEXTKennzeichen „eingehend" als Text (true/false)
answeredTEXTKennzeichen „angenommen" als Text (true/false)
has_faxTEXTFax-Kennzeichen als Text (true/false)
has_monitorTEXTMonitor-Kennzeichen als Text (true/false)
has_voicemailTEXTVoicemail-Kennzeichen als Text (true/false)
deletedTEXTKennzeichen aus dem STARFACE-CDR: Eintrag in der Rufliste gelöscht (true/false)
private_callTEXTKennzeichen „privater Anruf" (true/false)
callback_number_externTEXTKennzeichen „externe Rückrufnummer" aus dem STARFACE-CDR (true/false)
duration_sDECIMALGesamtdauer des Schritts in Sekunden (call_result_timestart_time)
summary_stepTEXTKennzeichen aus dem STARFACE-CDR, ob dieser Schritt der zusammenfassende Schritt des Anrufs ist (true/false)
start_time_hourTIMESTAMPstart_time, auf die Stunde gerundet
start_time_dayTIMESTAMPstart_time, auf den Tag gerundet
start_time_monthTIMESTAMPstart_time, auf den Monat gerundet
duration_mDECIMALGesamtdauer des Schritts in Minuten
talk_duration_sDECIMALGesprächsdauer des Schritts in Sekunden (call_result_timelink_time)
talk_duration_mDECIMALGesprächsdauer in Minuten
ringing_duration_sDECIMALKlingeldauer des Schritts in Sekunden (link_timeringing_time)
ringing_duration_mDECIMALKlingeldauer in Minuten
call_origin_typeTEXTUrsprung des Anrufs: Internal oder External
pbx_location_nameTEXTName des Anlagen-Standorts

Konten-Views

Elf strukturgleiche Views mit den Stammdaten aller Benutzer-, Gruppen- und iQueue-Konten der Anlage (Tabellen …_4). Jede View enthält denselben, vollständigen Kontenbestand einschließlich Platzhalterzeilen für „kein Konto" und „gelöschtes Konto"; die Mehrfachausführung dient BI-Werkzeugen wie Power BI, die je Beziehung eine eigene Nachschlagetabelle benötigen. Die Zuordnung:

ViewNachschlage-View für
CDR_AccountCDR_Summary.cdr_account_id
Caller_AccountCDR_Summary.caller_account_id
Called_AccountCDR_Summary.called_account_id
Call_Result_AccountCDR_Summary.call_result_caused_by
User_Call_AccountCDR_Summary.user_call_account_id
Group_Call_AccountCDR_Summary.group_call_account_id
CDR_Account_CDR_DataCDR_Data.cdr_account_id
Caller_Account_CDR_DataCDR_Data.caller_account_id
Called_Account_CDR_DataCDR_Data.called_account_id
Call_Result_Account_CDR_DataCDR_Data.call_result_caused_by
Group_Account_for_User_Group_StatesUser_Group_States.GROUP_ACCOUNT_ID

Spalten aller elf Konten-Views:

SpalteTypBedeutung
Account_IDTEXTKonto-ID mit Standortpräfix — der Verknüpfungsschlüssel; negative IDs sind Platzhalter für „kein Konto" bzw. „gelöschtes Konto"
Account_NameTEXTAnzeigename des Kontos; bei Platzhaltern z. B. „-" oder „Gelöschter Account"
Account_TypeTEXTKontotyp: AGENT (Benutzer), GROUP, IQUEUE oder UNKNOWN
Account_Type_i18nTEXTAnzeigetext dazu — „StarfaceUser", „Gruppe", „iQueue", „Unbekannt"
Queue_Max_Wait_TimeINTEGERMaximale Wartezeit laut iQueue-Konfiguration; -1 bei Konten ohne Warteschlange
Queue_SizeINTEGERWarteschlangengröße laut iQueue-Konfiguration; -1 bei Konten ohne Warteschlange
sam_account_nameTEXTWindows-Anmeldename (sAMAccountName) des Benutzers, sofern auf der Anlage gepflegt

Dienste-Views

Zwei strukturgleiche Views (Tabellen …_4) mit den STARFACE-Diensten aus der Anlagendatenbank — die Auflösung der service_id-Spalten der Gesprächsdaten: Service_for_CDR_Summary (für CDR_Summary.service_id) und Service_for_CDR_Data (für CDR_Data.service_id).

SpalteTypBedeutung
service_idTEXTDienst-ID mit Standortpräfix — der Verknüpfungsschlüssel
nameTEXTName des STARFACE-Dienstes

Modulnachrichten-Views

Zwei strukturgleiche Views (Tabellen …_4) für anrufbezogene Nachrichten anderer Module: Module_Message_for_CDR_Summary und Module_Message_for_CDR_Data, verknüpfbar über Call_ID mit den Gesprächsdaten. Das Schema ist Teil des Datenmodells; Inhalte werden von der aktuellen Modulversion nicht geschrieben — die Views sind leer.

SpalteTypBedeutung
Call_IDTEXTAnruf-ID — Verknüpfung zu CDR_Summary.call_id bzw. CDR_Data.call_id
Module_IDTEXTID des sendenden Moduls
Module_Instance_IDTEXTID der sendenden Modulinstanz
TimestampTIMESTAMPZeitpunkt der Nachricht
MessageTEXTNachrichteninhalt

Kennzahlen und Konstanten

Constant_Values

Tabelle Constant_Values_4. Ziel- und Maximalwerte aus den Moduleinstellungen (Grenzwerte für Berichte, z. B. Soll-Klingeldauer). Bei jedem Upload wird eine Zeile mit dem aktuellen Stand angefügt; die Zeile mit dem jüngsten timestamp ist der gültige Stand.

SpalteTypBedeutung
const_max_ringing_durationINTEGERMaximalwert Klingeldauer
const_target_ringing_durationINTEGERZielwert Klingeldauer
const_max_call_durationINTEGERMaximalwert Gesprächsdauer
const_target_call_durationINTEGERZielwert Gesprächsdauer
const_max_missed_callsINTEGERMaximalwert verpasste Anrufe
const_target_missed_callsINTEGERZielwert verpasste Anrufe
timestampTIMESTAMPZeitpunkt des Uploads dieser Konstanten

Measurements

Tabelle Measurements_4. Hilfstabelle des Power-BI-Datenmodells: Sie trägt dort die vordefinierten Kennzahlen (DAX-Measures wie Erreichbarkeit oder Anrufzahlen). In der SQL-Datenbank wird die Tabelle nur aus Gründen der Schema-Parität angelegt und enthält keine Nutzdaten.

SpalteTypBedeutung
timestampTIMESTAMPTechnische Ankerspalte; ohne Inhalte

Benutzer-, Gruppen- und Gerätezustände

Diese drei Views werden nur befüllt, wenn in der Modulkonfiguration der Export Benutzer-/Gruppenstatus aktiviert ist (Experten-Modus). Das Modul schreibt dann je Erfassungsintervall (Standard 60 Sekunden, Minimum 30) eine Momentaufnahme je Objekt. PERIOD_S gibt das konfigurierte Erfassungsintervall in Sekunden an — die Zeitspanne, die eine Momentaufnahme repräsentiert (Grundlage für Dauer-Hochrechnungen).

User_States

Tabelle User_States_4. Eine Zeile je Benutzer und Erfassungszeitpunkt.

SpalteTypBedeutung
timestampTIMESTAMPErfassungszeitpunkt der Momentaufnahme
ACCOUNT_IDTEXTKonto-ID des Benutzers (mit Standortpräfix)
DNDBOOLEAN„Nicht stören" zum Erfassungszeitpunkt aktiv
REDIRECT_ALWAYSBOOLEANImmer-Umleitung zum Erfassungszeitpunkt aktiv
PERIOD_SINTEGERErfassungsintervall in Sekunden

User_Group_States

Tabelle User_Group_States_4. Eine Zeile je Gruppenmitgliedschaft (Benutzer × Gruppe) und Erfassungszeitpunkt.

SpalteTypBedeutung
timestampTIMESTAMPErfassungszeitpunkt der Momentaufnahme
GROUP_ACCOUNT_IDTEXTKonto-ID der Gruppe — Schlüssel zu Group_Account_for_User_Group_States
USER_ACCOUNT_IDTEXTKonto-ID des Benutzers
IS_LOGGED_INBOOLEANBenutzer war zum Erfassungszeitpunkt in der Gruppe angemeldet
PERIOD_SINTEGERErfassungsintervall in Sekunden

User_Device_States

Tabelle User_Device_States_4. Eine Zeile je Telefonzuordnung (Benutzer × Endgerät) und Erfassungszeitpunkt.

SpalteTypBedeutung
timestampTIMESTAMPErfassungszeitpunkt der Momentaufnahme
USER_ACCOUNT_IDTEXTKonto-ID des Benutzers
PHONE_NAMETEXTName des Telefons bzw. Endgeräts
IS_ACTIVEBOOLEANTelefon war zum Erfassungszeitpunkt als aktives Gerät des Benutzers angemeldet
PERIOD_SINTEGERErfassungsintervall in Sekunden

Live-Daten

Die beiden Live-Views werden im Live-Daten-Intervall (Standard 10 Sekunden) fortlaufend ergänzt und wachsen entsprechend schnell. Über die Option Zurücksetzen der Live-Daten kann das Modul beide Tabellen periodisch leeren. Die Spalten …_account_id_timestamped kombinieren Konto-ID und Erfassungszeitpunkt zu einem Schlüssel, der Agent_State und iQueue_State je Momentaufnahme verknüpft.

Agent_State

Tabelle Agent_State_1. Eine Zeile je iQueue-Agent, Warteschlange und Erfassungszeitpunkt — inklusive des gerade laufenden Warteschlangen-Anrufs, falls vorhanden. Die Zustandsspalten enthalten sprachabhängige Anzeigetexte in der Berichtssprache (Beispielwerte: Deutsch).

SpalteTypBedeutung
timestampTIMESTAMPErfassungszeitpunkt der Momentaufnahme
account_id_timestampedTEXTKonto-ID des Agenten kombiniert mit dem Erfassungszeitpunkt (Verknüpfungsschlüssel)
queue_account_id_timestampedTEXTKonto-ID der Warteschlange kombiniert mit dem Erfassungszeitpunkt — Schlüssel zu iQueue_State
account_idTEXTKonto-ID des Agenten (mit Standortpräfix)
agent_nameTEXTName des Agenten
chat_presenceTEXTChat-Präsenz, z. B. „Verfügbar", „Weg", „Nicht Stören", „Frei zum Chatten"
chat_presence_messageTEXTIndividuelle Präsenznachricht des Agenten
telephony_stateTEXTTelefoniestatus, z. B. „Verfügbar", „Spricht", „Klingelt", „Nachbearbeitungszeit", „Nicht Verfügbar"
is_do_not_disturb_settingTEXT„Nicht stören"-Einstellung — „Aktiviert" / „Deaktiviert"
is_logged_inTEXTAnmeldestatus in der Warteschlange — „Angemeldet" / „Abgemeldet"
is_redirect_always_activeTEXTImmer-Umleitung — „Aktiviert" / „Deaktiviert"
call_idTEXTID des aktuellen Warteschlangen-Anrufs (ohne Standortpräfix); leer, wenn kein Anruf läuft
queue_account_idTEXTKonto-ID der Warteschlange (mit Standortpräfix)
call_stateTEXTZustand des aktuellen Anrufs — „Wartet", „Klingelt", „Verbunden", „Verlassen"; leer, wenn kein Anruf läuft
incoming_timeTIMESTAMPEingangszeitpunkt des aktuellen Anrufs
connected_timeTIMESTAMPVerbindungszeitpunkt des aktuellen Anrufs
caller_nameTEXTName des aktuellen Anrufers
caller_numberTEXTRufnummer des aktuellen Anrufers
durationDECIMALBisherige Dauer des aktuellen Anrufs in Minuten (0, wenn nicht verbunden)
pbx_location_nameTEXTName des Anlagen-Standorts

iQueue_State

Tabelle iQueue_State_1. Eine Zeile je iQueue-Warteschlange und Erfassungszeitpunkt.

SpalteTypBedeutung
timestampTIMESTAMPErfassungszeitpunkt der Momentaufnahme
queue_Account_IDTEXTKonto-ID der Warteschlange (mit Standortpräfix)
queue_account_id_timestampedTEXTKonto-ID kombiniert mit dem Erfassungszeitpunkt — Schlüssel zu Agent_State
connected_callsINTEGERAnzahl der aktuell verbundenen Anrufe der Warteschlange
waiting_callsINTEGERAnzahl der aktuell wartenden Anrufe (einschließlich klingelnder)
queue_nameTEXTName der Warteschlange
max_waiting_timeINTEGERMaximale Wartezeit laut iQueue-Konfiguration
queue_sizeINTEGERWarteschlangengröße laut iQueue-Konfiguration
pbx_location_nameTEXTName des Anlagen-Standorts